WriteJavaScript(stream,string,IList<PDFJavaScript>,string) Method

Summary

Writes (or removes) JavaScript actions to an output file.

Syntax

C++/CLI

public static void WriteJavaScript( 
   stream sourceStream, 
   string password, 
   IList<PDFJavaScript> Script_, 
   string destinationFileName 
)

public static void WriteJavaScript( 
   Stream^ sourceStream, 
   String^ password, 
   IList<PDFJavaScript>^ Script_, 
   String^ destinationFileName 
)

Parameters

sourceStream

Stream containing the source PDF.

password

The password to use if sourceStream contains an encrypted PDF file.

javaScript

List of WriteJavaScript actions to be written. If null or the array is empty, the function deletes the JavaScript from the source.

destinationFileName

Name of the destination PDF file.

Remarks

If javaScript is not null and contains valid JavaScript actions, WriteJavaScript will:

Copy the PDF file from sourceStream
Add the JavaScript actions
Write the result to destinationFileName

If the source PDF file contains JavaScript, those operations will be replaced by the actions from javaScript. To add JavaScript actions to the existing JavaScript actions from the source file, follow these steps:

Call PDFFile.ExtractJavaScript(stream,string) to read the existing JavaScript actions.
Add your actions to the existing list.
Write all the actions (existing and new) to the output file using WriteJavaScript.

If javaScript is null, WriteJavaScript will remove any JavaScript from the file.

There are several variations of this function, which take the source from a disk file or a stream and write the output to a disk file or a stream.

The actions from javaScript will be sorted in ascending order by the PDFJavaScript.Name property. This means the order in which the JavaScript actions are written to the file and executed by the JavaScript interpreter is not necessarily the order in which you add them to the javaScript list. See PDFJavaScript.Name for more details.

The example below demonstrates the result of this sorting. The example adds two actions named name2 and name1. The write however, changes the order and writes them in the order name1, name2. So when you load the resulting PDF file in a viewer that supports JavaScript (eg: web browser), the messages are displayed in reverse order.

Example

using Leadtools.WinForms; 
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.Controls; 
using Leadtools.Drawing; 
using Leadtools.ImageProcessing; 
using Leadtools.Pdf; 
using Leadtools.Svg; 
 
 
public void TestWriteJavaScript_Stream_string_IList_string() 
{ 
   string srcFileName = Path.Combine(LEAD_VARS.ImagesDir, "leadtools.pdf"); 
   string dstFileName = Path.Combine(LEAD_VARS.ImagesDir, @"out.pdf"); 
   List<PDFJavaScript> list = new List<PDFJavaScript>(2); 
   PDFJavaScript item; 
 
   item.Name = "name2"; 
   item.Code = "app.alert(\"Hello 2\");"; 
   list.Add(item); 
 
   item.Name = "name1"; 
   item.Code = "app.alert(\"Hello 1\");"; 
   list.Add(item); 
 
   using (FileStream srcStream = File.Open(srcFileName, FileMode.Open)) 
      PDFFile.WriteJavaScript(srcStream, null, list, dstFileName); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS22\Resources\Images"; 
}

Requirements

Target Platforms

Reference

PDFFile Class

PDFFile Members

PDFFile.ExtractJavaScript

PDFFile.WriteJavaScript

Leadtools.Pdf Namespace

Download our FREE evaluation

Help Version 22.0.2023.7.10

Leadtools.Pdf Assembly

Introduction

Getting Started

Namespaces

Leadtools.Pdf Namespace

Assemblies